<!--
 * @Author: Ryan
 * @Date: 2022-12-08 12:06:25
 * @LastEditors: Ryan
 * @LastEditTime: 2022-12-08 17:45:27
 * @Description: 开发指南-路由和菜单
 * @FilePath: \vue-admin-system\src\views\develop\route\index.vue
-->

<template>
  <div class="app-container">
    <div class="route-container">
      <div class="block">
        <h2>配置项</h2>
        <p>菜单路由统一在'src/router/modules'目录下进按菜单模块行管理和维护。通常开发新功能前需要配置菜单，目前提供以下配置项</p>
        <code-editor
          :value="configValue"
          :display_language="false"
          font_size="14px"
          width="100%"
        />
        <el-divider />
      </div>

      <div class="block">
        <h2>示例</h2>
        <code-editor
          :value="exampleValue"
          :display_language="false"
          font_size="14px"
          width="100%"
        />
        <el-divider />
      </div>

      <div class="block">
        <h2>多级目录(嵌套路由)</h2>
        <p>如果你的路由是多级目录，比如有三级路由嵌套的情况下，需手动在二级目录的根文件下添加一个 router-view。原则上有多少级路由嵌套就需要多少个router-view</p>
        <code-editor
          :value="multiValue"
          :display_language="false"
          font_size="14px"
          width="100%"
        />
        <el-divider />
      </div>

      <div class="block">
        <h2>侧边栏外链</h2>
        <p>支持在侧边栏中配置一个外链，只要在 path 中填写了合法的 url 路径，当点击侧边栏的时候就会新开这个页面</p>
        <code-editor
          :value="linkValue"
          :display_language="false"
          font_size="14px"
          width="100%"
        />
      </div>
    </div>
  </div>
</template>

<script>
import CodeEditor from 'simple-code-editor'
export default {
  name: 'DevelopRoute',
  components: { CodeEditor },
  data() {
    return {
      configValue: `
    // 当设置 true 时，该路由不会在侧边栏出现 如401，login等页面，或者如一些编辑页面/edit/1
    hidden: true // (默认 false)

    // 当设置 noRedirect 时，该路由在面包屑导航中不可被点击
    redirect: 'noRedirect'

    // 当一个路由下面的 children 声明的路由大于1个时，自动会变成嵌套的模式--如组件页面
    // 只有一个时，会将该子路由当做根路由显示在侧边栏
    // 若想不管路由下面的 children 声明的个数都显示你的根路由
    // 你可以设置 alwaysShow: true，这样就会忽略之前定义的规则，一直显示根路由
    alwaysShow: true

    // 设定路由的名字，必填，否则使用<keep-alive>时会出现各种问题
    name: 'router-name'

    meta: {
      // 设置该路由进入的权限，支持多个权限叠加
      roles: ['admin', 'develop']

      // 设置该路由在侧边栏和面包屑中展示的名字
      title: 'title'

      // 设置该路由的图标，支持 svg-class和el-icon-x element-ui 的 icon，可在菜单[组件功能-图标]中查找
      icon: 'svg-name'

      // 设置为true，则不会被 <keep-alive> 缓存(默认 false)
      noCache: true

      // 设置为false，则不会在breadcrumb面包屑中显示(默认 true)
      breadcrumb: false

      // 设置为true，它则会固定在tags-view中(默认 false)
      affix: true

      // 当路由设置了该属性，则会高亮相对应的侧边栏。
      // 这在某些场景非常有用，比如：一个文章的列表页路由为：/article/list
      // 点击文章进入文章详情页，这时候路由为/article/1，但你想在侧边栏高亮文章列表的路由，就可以进行如下设置
      activeMenu: '/article/list'
    }
      `,
      exampleValue: `
    {
      path: '/permission',
      component: Layout,
      redirect: '/permission/index', //重定向地址，在面包屑中点击会重定向去的地址
      hidden: true, // 不在侧边栏显示
      alwaysShow: true, //一直显示根路由
      meta: { roles: ['admin','editor'] }, //你可以在根路由设置权限，这样它下面所有的子路由都继承了这个权限
      children: [{
        path: 'index',
        component: ()=>import('permission/index'),
        name: 'permission',
        meta: {
          title: 'permission',
          icon: 'lock', //图标
          roles: ['admin','editor'], //或者你可以给每一个子路由设置自己的权限
          noCache: true // 不会被 <keep-alive> 缓存
        }
      }]
    }
      `,
      multiValue: `
    <!-- 父级路由组件  -->
    <template>
      <div>
        <!-- xxx html 内容  -->
        <router-view />
      </div>
    </template>
      `,
      linkValue: `
    {
      "path": "external-link",
      "component": Layout,
      "children": [
        {
          "path": "https://www.prizecity.io",
          "meta": { "title": "externalLink", "icon": "link" }
        }
      ]
    }
      `
    }
  }
}
</script>

<style scoped lang="scss">
.route-container {
  // width: 870px;
  margin: 0 auto;
  padding: 30px;
  box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);

  @media (max-width: 992px) {
    width: auto;
  }

  .block {
    h2 {
      padding-bottom: 20px;
    }

    h4 {
      padding-top: 10px;
      padding-bottom: 10px;
    }
  }
}
</style>
